home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / ued19ce.zip / UED.DOC < prev    next >
Text File  |  1991-09-08  |  40KB  |  997 lines
  1.  
  2.  
  3.                   Useful Editor (Version 1.9c) Documentation
  4.                   ==========================================
  5.  
  6.  
  7.      Features
  8.      ~~~~~~~~
  9.  
  10.      Useful Editor (Ued) is a small (about 35K), fast, ASCII editor that is
  11.      suitable for a wide variety of text manipulation tasks.  Some of Ued's
  12.      features include:
  13.  
  14.         - ability to edit up to 9 files in memory at once
  15.         - files as large as 1000 characters wide and 10,000 lines long
  16.         - file size is only limited by available memory
  17.         - split screen editing
  18.         - typeover and insert mode editing
  19.         - search and replace (both case sensitive and insensitive)
  20.         - cut and paste (three modes: line, range, and block)
  21.         - escape to DOS
  22.         - can load "piped" files
  23.         - wildcard expansion of command line arguments
  24.         - word wrap and paragraph reformat
  25.         - smart indentation
  26.         - easy to use consistent interface
  27.         - user configurable preferences
  28.  
  29.  
  30.      System Requirements
  31.      ~~~~~~~~~~~~~~~~~~~
  32.  
  33.      Ued runs on any IBM PC or compatible.  Ued automatically determines
  34.      the  type of video card installed and switches the card into 80 X 25
  35.      text mode when it starts up.  The following video cards (or ones that
  36.      are compatible) are supported:
  37.  
  38.         - Color Graphics Adapter (CGA)
  39.         - Monochrome Graphics Adapter (MGA)
  40.         - Hercules Graphics Adapter (HGA)
  41.         - Enhanced Graphics Adaptor (EGA)
  42.         - Video Graphics Array (VGA)
  43.         - Multi-Color Graphics Array (MCGA)
  44.  
  45.      Any monitor that can display 80 X 25 text works with Ued.  If you have
  46.      a color monitor and card, you can change the default colors (of black
  47.      and white) by running uedcfg.exe (see Configuring Ued).  In addition
  48.      Ued supports a 43 line display on EGA systems and a 28 or 50 line
  49.      display on VGA systems.
  50.  
  51.      Ued is very small and runs on systems with as little as 128K of
  52.      memory.  Of course the more memory that you have, the larger the files
  53.      that you are able to edit.
  54.  
  55.  
  56.  
  57.      Starting Up Ued
  58.      ~~~~~~~~~~~~~~~
  59.  
  60.      From the DOS prompt, type:
  61.  
  62.         Ued <filename1> <filename2> ... <filename9> [/l]
  63.  
  64.      then press the Enter key.
  65.  
  66.      Each "filename" is either an ASCII text file that you want to edit or
  67.      the name of a file that you want to create.  Up to 9 file names can be
  68.      specified on the command line when starting up Ued and can contain
  69.      wildcard characters.  Each file is assigned to its own workspace.
  70.  
  71.      Piping to Ued is allowed.  For instance if you typed the command:
  72.  
  73.         dir | Ued
  74.  
  75.      A directory listing would be loaded into Ued with the name "PIPED".
  76.  
  77.      You can also start up Ued with no files specified.  In this case the
  78.      editor starts within an empty unnamed workspace.
  79.  
  80.      The command line argument /l can be added when you are loading very
  81.      large files.  Only a single file should be loaded if the /l option is
  82.      used.
  83.  
  84.  
  85.      Workspaces
  86.      ~~~~~~~~~~
  87.  
  88.      Files are loaded into Ued "workspaces".  A workspace can be as much as
  89.      1,000 characters wide, and 10,000 lines deep.  You can move the cursor
  90.      anywhere in the workspace to edit text.  The "text window" follows the
  91.      cursor as you move about the workspace.
  92.  
  93.      There are 9 workspaces (numbered 1-9) in Ued, each of which can hold a
  94.      single file.  The F2 Workspace command is used to switch between work-
  95.      spaces.
  96.  
  97.      Ued maintains one other workspace (workspace 0) which is used as a
  98.      "clipboard" when you Cut and Paste text.
  99.  
  100.  
  101.      Screen Layout
  102.      ~~~~~~~~~~~~~
  103.  
  104.      Ued uses the top 23 lines of the screen to display the text being
  105.      edited.  Consider this to be a "window" (that is 80 columns wide and
  106.      23 lines deep) into the "text workspace".  This window is bordered on
  107.      the top and sides by the edge of the screen, and bounded on the bottom
  108.      by an inverse line.
  109.  
  110.      That inverse line is called the "status line".  On the left edge of
  111.      the status line is a number (0-9) which indicates what workspace that
  112.      you are in.  Beside it appears the name of the file that you are edit-
  113.      ing in that workspace.  To the right side of the status line, the line
  114.      and column position of the cursor is displayed.
  115.  
  116.      Below the status line are the command lines.  All of the commands that
  117.      are currently available to you are displayed on these two lines.
  118.  
  119.  
  120.  
  121.      The Cursor(s)
  122.      ~~~~~~~~~~~~~
  123.  
  124.      The "cursor" is a pointer within a workspace.  Text can be added or
  125.      deleted here.  In Ued the cursor appears as a solid inverted block
  126.      when you are in "insert mode", and a flashing underscore when you are
  127.      in "typeover mode".
  128.  
  129.      When you start up Ued a cursor appears in the upper left hand corner
  130.      of the text window.  This is your "active" cursor.  In actual fact
  131.      there are two cursors in Ued.  An "inactive" cursor is initially pos-
  132.      itioned there as well but not displayed.
  133.  
  134.      When you move the active cursor, the inactive cursor remains where it
  135.      is.  You can move the active cursor to the inactive cursor position by
  136.      using the "Flip" command (Ctrl-F).  The position that you moved from
  137.      becomes the inactive cursor position.  The inactive cursor can be used
  138.      as a "bookmark" in your text (a place that you want to get to quickly)
  139.      and also plays an important role in the F8 Split command.
  140.  
  141.  
  142.      Moving the Cursor
  143.      ~~~~~~~~~~~~~~~~~
  144.  
  145.      Moving the cursor around can be accomplished with the following keys.
  146.      In all cases, the text window is adjusted when necessary in order to
  147.      keep the cursor on the screen.
  148.  
  149.  
  150.      Up Arrow   Moves the cursor up one line of text.
  151.  
  152.      Down Arrow Moves the cursor down one line of text.
  153.  
  154.      ->         Moves the cursor right one character.
  155.  
  156.      <-         Moves the cursor left one character.
  157.  
  158.      Home       Moves the cursor to the first character on the current
  159.                 line.  If you are already on the first character, moves the
  160.                 cursor to column 1.
  161.  
  162.      End        Moves the cursor one position past the last character on
  163.                 the current line.
  164.  
  165.      PgUp       Moves the cursor up one screen of text.
  166.  
  167.      PgDn       Moves the cursor down one screen of text.
  168.  
  169.  
  170.  
  171.  
  172.      Additional cursor movement commands can be accessed by holding down
  173.      the "Ctrl" key (you will see the menu change when you do this) and
  174.      pressing one of these keys:
  175.  
  176.  
  177.      Ctrl ->    Moves the cursor to the beginning of the next word.  (A
  178.                 word is considered to be a series of characters preceded
  179.                 and followed by at least one space.)
  180.  
  181.      Ctrl <-    Moves the cursor to the beginning of the previous word.
  182.  
  183.      Flip       Moves the active cursor to the inactive cursor position.
  184.                 The current cursor position becomes the inactive cursor.
  185.  
  186.      Goto Line  Prompts for a line number, then moves the cursor to the
  187.                 line number entered.  Adjusts the text window so that the
  188.                 cursor is centered vertically in the window.
  189.  
  190.      Outdent    Moves the cursor left to the previous level of indentation.
  191.  
  192.      Back
  193.      Workspace  Moves the cursor to the previous (lower numbered) work-
  194.                 space.
  195.      Next
  196.      Workspace  Moves the cursor to the next workspace.
  197.  
  198.      Ctrl Home  Moves the cursor to the first line of the current file.
  199.  
  200.      Ctrl End   Moves the cursor one line past the end of the current file.
  201.  
  202.      Ctrl PgDn  When a search Pattern has been defined, moves the cursor to
  203.                 the next occurrence of Pattern in the text.
  204.      
  205.      Ctrl PgUp  When a search Pattern has been defined, moves the cursor to
  206.                 the previous occurrence of Pattern in the text.
  207.  
  208.  
  209.      Entering Text
  210.      ~~~~~~~~~~~~~
  211.  
  212.      To enter text into Ued, position the cursor where you want the text to
  213.      be added and then type.  If you make a mistake use the Backspace or
  214.      Del key to erase the error.  In insert mode, characters to the right
  215.      of the solid block cursor (including the current character) shift
  216.      right to make room for new text being entered.
  217.  
  218.      You can do "power" data entry using Ued by turning on the "word wrap"
  219.      feature found under the Text command.  When you turn word wrap on you
  220.      will notice an inverse line appear down the right side of the screen.
  221.      This line marks the right margin.  With word wrap on, any word that is
  222.      incomplete when it "hits" the right margin is moved down to the next
  223.      line.  With this feature you can enter long passages of text without
  224.      having to worry about the ends of lines.  You can alter the position
  225.      of the right margin with the Set and Enter options of the Text
  226.      command.
  227.  
  228.      All extended charcaters (with ASCII values > 127) can be entered by
  229.      holding down the Alt key and typing in the character's decimal value
  230.      using either the keypad numbers or the number keys on the top row.
  231.  
  232.  
  233.  
  234.      Ued considers a block of text separated by at least one blank line
  235.      above and below to be a paragraph.  Lines beginning with a '.' or a
  236.      ':' are also considered to be paragraph separators.  Editing text
  237.      within a paragraph when word wrap is on might be a little
  238.      disconcerting at first, especially when in insert mode.  Ued makes no
  239.      attempt to reformat paragraph text "on-the-fly" as you are editing it.
  240.      When in insert mode Ued moves any text to the right of the cursor down
  241.      to the next line (if necessary) to make room for new text.  The
  242.      Paragraph Reformat option under the Text command can be used to fix
  243.      things up after you have made all your changes.
  244.  
  245.  
  246.      Smart Indentation
  247.      ~~~~~~~~~~~~~~~~~
  248.  
  249.      When you press the Enter key, the cursor moves down one line and Ued
  250.      positions the cursor under the first character of the current line.
  251.      This makes it easy to enter blocks of indented text.
  252.  
  253.      Similarly the Paragraph Reformat looks at the leading spaces on the
  254.      second line of a paragraph to determine where to place the left margin
  255.      (the right margin is "set" explicitly).  Any positive or negative
  256.      indentation on the first line will be preserved.
  257.  
  258.      The Outdent option under the Ctrl key moves the cursor to the previous
  259.      level of indentation (which it determines by looking "up" in the text
  260.      of the workspace).
  261.  
  262.  
  263.      Deleting Things
  264.      ~~~~~~~~~~~~~~~
  265.  
  266.      Characters are deleted with the following keys:
  267.  
  268.  
  269.      Del        Deletes the character under the cursor.  Any text to the
  270.                 right of that character shifts left to "fill the gap".  If
  271.                 the cursor is past the end of the line and you are in
  272.                 insert mode, Ued brings up the next line of text and joins
  273.                 it with the current line.
  274.  
  275.      Backspace  Moves the cursor left one character.  If you are in insert
  276.                 mode, Ued deletes the character to the left of the cursor
  277.                 and all text to the right of and including the cursor
  278.                 shifts left.  Also in insert mode, if the cursor is in
  279.                 column 1, Ued moves the current line up and joins it with
  280.                 the previous line.
  281.  
  282.      Backtab    Moves the cursor to the previous tab stop.  If you are in
  283.                 insert mode, all characters to the left of the cursor up to
  284.                 and including the previous tab stop are deleted.
  285.  
  286.  
  287.  
  288.      By pressing and holding down the Alt key, a sub-menu with the follow-
  289.      ing additional delete options appears:
  290.  
  291.      Word       Deletes the word under the cursor.  If the cursor is not on
  292.                 a word, the first word to the left of the cursor (if
  293.                 there is one) is deleted.
  294.  
  295.      Beginning
  296.       of Line   Deletes all of the text to the left of the cursor.  The
  297.                 remaining text and the cursor shift left to the current
  298.                 level of indentation.
  299.  
  300.      End
  301.       of Line   Deletes all of the text to the right of and including the
  302.                 character under the cursor.
  303.  
  304.      Line       Deletes the line that the cursor is on.
  305.  
  306.  
  307.      Other Keys You Should Know About
  308.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  309.  
  310.      The following keys are important to the operation of Ued:
  311.  
  312.      Esc        Returns to the previous level of menus.  If you are at the
  313.                 main command menu nothing happens.
  314.  
  315.      Ins        Switches between "typeover" and "insert" modes.
  316.  
  317.      Enter      Moves the cursor down one line and positions it at the cur-
  318.                 rent level of indentation.  If you are in insert mode, a
  319.                 new line is created immediately after the current line, and
  320.                 any text to the right of and including the cursor character
  321.                 is moved down with the cursor.
  322.  
  323.      Tab        Moves the cursor to the next tab stop.  If you are in
  324.                 insert mode, characters to the right of and including the
  325.                 cursor character shift right with the cursor.
  326.  
  327.  
  328.      Entering Control Characters
  329.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  330.  
  331.      For the most part, the technique of holding down the Alt key then
  332.      typing the 3-digit decimal equivalent of the desired control character
  333.      on the number pad will work with Ued.  However to get the symbol
  334.      corresponding to an Esc or Arrow key (for instance) into your file,
  335.      Ued requires that you to use the Alt key in conjunction with the
  336.      number keys on the top row of the keyboard.
  337.  
  338.  
  339.  
  340.      Main Menu Commands
  341.      ~~~~~~~~~~~~~~~~~~
  342.  
  343.      The function keys F1 - F10 are used to access the main Ued command
  344.      set.  These commands are invoked by pressing the appropriate function
  345.      key.  In addition, pressing and holding down the Ctrl key reveals
  346.      additional cursor movement keys.  Pressing and holding down the Alt
  347.      key is used for Delete functions.
  348.  
  349.      Many of the main menu commands have sub-options.  Sub-option menus
  350.      replace the main command menu when invoked.  They show the main com-
  351.      mand selected in inverse text (just below the file name on the status
  352.      line) and the option choices on the bottom line of the screen.  You
  353.      select an option by pressing the first (highlighted) letter or char-
  354.      acter of the appropriate choice.
  355.  
  356.      You can always get out of sub-option menu(s) by pressing the Esc key,
  357.      or by selecting another main menu command.
  358.  
  359.      The sections that follow describe the main menu commands and sub-
  360.      options in more detail.
  361.  
  362.  
  363.  
  364.      F1 File
  365.      ~~~~~~~
  366.  
  367.      File commands are used to copy Ued workspaces to and from disk files.
  368.      In addition the current workspace can be erased or renamed.
  369.  
  370.  
  371.      Load       Prompts for the name of a file to load.  If the entered
  372.                 file name is found on the disk in the current directory,
  373.                 Ued copies it into the workspace at the current cursor
  374.                 position.  Existing text is moved to make room for the text
  375.                 being loaded.  An empty workspace is given the name of the
  376.                 first file loaded into it.
  377.  
  378.                 If you are not sure what the name of the file is, pressing
  379.                 Enter at the prompt for a file name will generate a list of
  380.                 all the files in the current directory and allow you to
  381.                 select one of them.  In addition you can type a partial
  382.                 file name using the standard DOS wildcard characters (*,?)
  383.                 to obtain a list of specific files to select from.
  384.  
  385.      Save       The workspace text is copied to a disk file in the current
  386.                 directory and given the current workspace name.  Ued
  387.                 prompts for a file name if the workspace is unnamed.  If
  388.                 the "backups" option is on, a backup copy of the file on
  389.                 disk to be over written is created with a .bak extension
  390.                 prior to saving.  Thus if you save over a file by mistake
  391.                 you can immediately recover from the backup copy.
  392.  
  393.      Name       Prompts for a name for the current workspace.  The name
  394.                 entered must be a valid DOS file name.  If the name is the
  395.                 same as one on your disk in the current directory, Ued 
  396.                 prompts you to verify that you really want to use that 
  397.                 name.
  398.  
  399.      Clear      Erases the contents of the current workspace.  If the work-
  400.                 space has been changed since that last time it was saved,
  401.                 Ued prompts you to verify that you really want to clear the
  402.                 workspace.
  403.  
  404.  
  405.      F2 Workspace
  406.      ~~~~~~~~~~~~
  407.  
  408.      The Workspace command allows you to switch between the files that you
  409.      have loaded.  In addition some status information about workspaces is
  410.      displayed as follows:
  411.  
  412.  
  413.      >          This symbol appears to the left of a workspace number if
  414.                 that workspace has been used at any time during the current
  415.                 edit session.
  416.  
  417.      *          When this symbol appears immediately after a workspace
  418.                 number it means that the workspace has been changed in some
  419.                 way since it was last saved.
  420.  
  421.      <-         This arrow points to the number of the workspace that is
  422.                 currently being displayed in the active window.
  423.  
  424.  
  425.  
  426.      To move between workspaces use the following keys:
  427.  
  428.  
  429.      <-         Displays the previous (lower numbered) workspace.
  430.  
  431.      ->         Displays the next workspace.
  432.  
  433.      Enter      Moves you into the workspace pointed to by <-.
  434.  
  435.      0 - 9      Moves directly to the workspace who's number is pressed.
  436.  
  437.      Esc        Moves you to the workspace that was active when the F2
  438.                 Workspace command was invoked.
  439.  
  440.  
  441.      F3 Search
  442.      ~~~~~~~~~
  443.  
  444.      Search allows you to find strings or "Patterns" within the text of the
  445.      current workspace and optionally substitute a "Replacement" string of
  446.      your choosing.
  447.  
  448.  
  449.      Count      Displays the total number of times that the Search Pattern
  450.                 appears in the text of the current workspace.
  451.  
  452.      Fix        Substitutes the Replacement string for a Pattern string
  453.                 provided that the cursor is on a piece of text matching
  454.                 Pattern (the text will be highlighted).
  455.  
  456.      Global     All instances of text in the current workspace matching the
  457.                 Pattern string are changed to the Replacement string.
  458.  
  459.      Pattern    Prompts for a search Pattern.  If the Pattern entered is in
  460.                 all lower case, searches will be case insensitive.  If any
  461.                 of the letters in the Pattern are in upper case, the work-
  462.                 space text and Pattern must be exactly the same for a match
  463.                 to occur.
  464.  
  465.      Replace-
  466.       ment      Prompts for a Replacement string.  The Replacement string
  467.                 can be empty, which has the effect of deleting the Pattern
  468.                 when a Fix or Global substitution is applied.  Changing the
  469.                 Pattern does not affect the current Replacement string.
  470.  
  471.      PgUp       Moves the cursor to the previous occurrence of Pattern in
  472.                 the current workspace.  If there are no more matches, moves
  473.                 the cursor to the beginning of the workspace.
  474.  
  475.      PgDn       Moves the cursor to the next occurrence of Pattern in the
  476.                 current workspace.  If there are no more matches, moves the
  477.                 cursor to the end of the workspace.
  478.  
  479.  
  480.  
  481.      F4 Print
  482.      ~~~~~~~~
  483.  
  484.      The contents of the current workspace are sent to the printer attached
  485.      to LPT1.  No formatting is performed on the text.
  486.  
  487.  
  488.      F5 Cut
  489.      ~~~~~~
  490.  
  491.      Cut allows you to select a block of text which can subsequently be
  492.      deleted, copied, moved, or shifted.  Text selection begins at the
  493.      current cursor position.  As you move the cursor around (using the
  494.      standard cursor movement keys) selected text is highlighted.
  495.      Selection ends when you press the Copy, Delete, or Move command keys.
  496.      How the text gets marked out depends on the Cut mode that you are in.
  497.      The three Cut styles are:
  498.  
  499.  
  500.      Block      A rectangular block of text.
  501.  
  502.      Line       Whole lines of text only.
  503.  
  504.      Range      All the text from one selected position in the text to
  505.                 another.
  506.  
  507.  
  508.      Any time that you select a block of text and copy, move, or delete it,
  509.      the selected text is copied to workspace 0.  Workspace 0 thus acts as
  510.      the "clipboard" or "cut buffer" for Ued.  The former contents of work-
  511.      space 0 are lost when newly selected text is copied to it.  You can
  512.      edit in workspace 0 as you would any other workspace, but you have to
  513.      be careful because of the transient nature of the text placed here
  514.      (ie. its NOT a good idea to load files into workspace 0).
  515.  
  516.      Once marked, there are four operations that can be performed on the
  517.      highlighted text.
  518.  
  519.      
  520.      Copy       Copies the selected text to workspace 0.
  521.  
  522.      Delete     Copies the selected text to workspace 0 then removes it
  523.                 from the current workspace.
  524.  
  525.      Move       Copies the selected text to workspace 0, removes it from
  526.                 the workspace, then prompts you to position the cursor
  527.                 where you want the text moved.  When you press Enter to
  528.                 complete the operation, the selected text is copied to the
  529.                 new location.
  530.  
  531.      +/-        Shifts the selected text right (+) or left (-).  Text 
  532.                 cannot be shifted over text that is not highlighted.  You 
  533.                 will notice that the highlighting does not go away.  After 
  534.                 shifting you can perform one of the other Cut operations,
  535.                 or press Esc to quit the Cut command.  
  536.  
  537.  
  538.  
  539.      F6 Paste
  540.      ~~~~~~~~
  541.  
  542.      This command copies the text from workspace 0 into the current work-
  543.      space at the current cursor position.  If you are in insert mode, the
  544.      workspace text is moved to make room for the workspace 0 text being
  545.      added.  Care should be exercised when you are in typeover mode as the
  546.      workspace 0 text is copied on top of the text in the current work-
  547.      space.  If there are more than 2 lines of text being Pasted and you
  548.      are in typeover mode, you are asked to verify that you really want to
  549.      Paste.
  550.  
  551.  
  552.      F7 DOS
  553.      ~~~~~~
  554.  
  555.      When you press F7, Ued starts up another DOS session by executing the
  556.      secondary command processor.  Ued looks at the environment variable
  557.      COMSPEC= for the name of the secondary command processor.  This is
  558.      usually COMMAND.COM.
  559.  
  560.      The F7 Dos command fails if:
  561.  
  562.         - COMSPEC= is not set in the environment
  563.         - the command processor indicated by COMSPEC could not be found
  564.         - there is not enough memory to run the command processor
  565.  
  566.      To return to Ued, from the DOS prompt type:
  567.  
  568.         exit
  569.  
  570.      then press the Enter key.
  571.  
  572.  
  573.      F8 Split/Zoom
  574.      ~~~~~~~~~~~~~
  575.  
  576.      Pressing F8 splits the text window horizontally at the current cursor 
  577.      position.  A second status line appears separating the two windows.  
  578.      The upper window shows the text at the active cursor, while the lower
  579.      window shows the text at the inactive cursor position.  You can flip
  580.      between the windows using the Ctrl-F command.
  581.  
  582.      Both windows can "view" the same workspace, or each can be positioned
  583.      on a different workspace.  If they are both positioned over the same
  584.      piece of text, changes made in one will be echoed to the other.
  585.  
  586.      Pressing F8 again expands (zooms) the window containing the active
  587.      cursor to be the size of a full screen.  The window containing the 
  588.      text pointed to by the inactive cursor is no longer displayed.
  589.  
  590.  
  591.  
  592.      F9 Text
  593.      ~~~~~~~
  594.  
  595.      The Text command offers some simple word processing options.
  596.  
  597.  
  598.      Enter
  599.       Right
  600.        Margin   Prompts for the column that you want words to wrap at.  The
  601.                 column must be in the range 20 to 250.
  602.  
  603.      Set
  604.       Right
  605.        Margin   The right margin is placed one character position past the
  606.                 longest line in the current paragraph (ie. the one that the
  607.                 cursor is on).
  608.  
  609.      Reformat
  610.       Paragraph Adjusts the text in the current paragraph so that each line
  611.                 has the maximum number of words between the left and right
  612.                 margins.  The left margin is determined by looking at the
  613.                 number of spaces preceding the second line of the para-
  614.                 graph.  The right margin is set with one of the above
  615.                 commands.
  616.  
  617.      Word Wrap  Turns the word wrap feature ON or OFF.
  618.  
  619.      25,43,50
  620.       Lines     Changes the number of lines displayed on the screen.  This
  621.                 option is only available if you have an EGA or VGA monitor.
  622.  
  623.  
  624.      F10 Quit
  625.      ~~~~~~~~
  626.  
  627.      This command is used to exit Ued.  If any of the workspaces have been
  628.      modified in any way, you are prompted to verify that you really want
  629.      to quit.
  630.  
  631.  
  632.  
  633.      Configuring Ued
  634.      ~~~~~~~~~~~~~~~
  635.  
  636.      A separate program (uedcfg.exe) is provided to modify Ued with some of
  637.      your own preferences.  When you run this Ued Configuration, you must
  638.      ensure that Ued.exe is in the current directory.  Follow the prompts
  639.      for the configuration program, and when you have answered the last
  640.      question Ued.exe will be updated with your selections.
  641.  
  642.      The following user preferences can be configured within Ued:
  643.  
  644.         - video display mode
  645.         - initial text entry mode
  646.         - initial Cut style
  647.         - color of normal text
  648.         - color of inverse text
  649.         - distance between tab stops
  650.         - initial right margin column
  651.  
  652.      Uedcfg will create also Ued.cfg file.  This small configuration file
  653.      can be used to re-configure a newer version of Ued without having to
  654.      answer the questions again.  Again making sure that Uedcfg.exe,
  655.      Ued.exe and Ued.cfg are all in the same directory simply type:
  656.  
  657.         uedcfg /r
  658.  
  659.      and your new verion of Ued will be setup with your current settings.
  660.  
  661.      If for any reason there is no Ued.cfg file, you can generate one by
  662.      typing:
  663.  
  664.         uedcfg /s
  665.  
  666.      Of course you should do this before copying the new version of Ued
  667.      over the old.
  668.  
  669.  
  670.  
  671.  
  672.  
  673.      Licensing
  674.      ~~~~~~~~~
  675.  
  676.              The programs and documentation in this archive are
  677.                  Copyright (c) 1989-1991 by Useful Software
  678.  
  679.      Ued is a shareware editor.  This means that you only pay for it if you
  680.      decide to continue using it.  If you don't think that it is worth the
  681.      asking price, delete the program, or better yet give it to someone who
  682.      might find it useful.  However if you do decide to keep Ued after a 2
  683.      week trial period, please send $20 (see REGISTRATION FORM on next
  684.      page) to:
  685.  
  686.         Useful Software
  687.         340 Dale Crescent
  688.         Waterloo, Ontario
  689.         Canada, N2J 3Y3
  690.  
  691.      The shareware fee pays for unlimited use of Ued by a single person.
  692.      You are allowed (and encouraged) to give away copies of Ued with the
  693.      understanding that each person receiving a copy is under the same
  694.      obligation as you are to send in the shareware fee if they decide to
  695.      keep it.  You can upload Ued to other computer systems, either free or
  696.      commercial, as long as this archive remains intact, with the copyright
  697.      and shareware notices unchanged.
  698.  
  699.      Useful Editor can be installed on LANS.  In such situations I ask only
  700.      that the LAN Administrator estimate the maximum number of people that
  701.      will be making "simultaneous" use of Ued and pay the shareware fee
  702.      based on that estimate.  I do not expect that the limit be closely
  703.      monitored or enforced (I appreciate how much trouble that would be),
  704.      but I do expect that the estimate will be revised (and additional fees
  705.      paid) should a substantial increase in the number of nodes on the LAN
  706.      and Ued usage occur.
  707.  
  708.      No guarantee is made as to the functionality of this software; however
  709.      it has been tested quite thoroughly by a large number of people.  If
  710.      it doesn't do what you want, don't keep it and send no money.
  711.  
  712.      Please support the shareware concept.  Shareware means useful programs
  713.      at a fraction of the cost you might pay for them commercially.  You
  714.      can try-before-you-buy, and you are not subjected to copy protection
  715.      or other atrocities that many software vendors inflict on their
  716.      customers.  Software updates can also be distributed much faster than
  717.      is possible through normal channels.
  718.  
  719.      Any questions, suggestions, or bug reports, can be mailed to the above
  720.      address, or send electronic mail to:
  721.  
  722.              GEnie:   M.GARDI
  723.         CompuServe:   70242,3102
  724.  
  725.  
  726.      Enjoy,
  727.  
  728.      Useful Software
  729.  
  730.  
  731.  
  732.      Registration Information (What do I get if I register!)
  733.      ~~~~~~~~~~~~~~~~~~~~~~~~
  734.  
  735.      All registered users of Useful Editor will receive one update with the
  736.      most recent version of the program.  Subsequent updates are available
  737.      for $2.00 shipping and handling on request.  In addition you will
  738.      receive the latest versions of other Useful Software products for your
  739.      consideration.
  740.  
  741.      Registered users will have access to the Useful Software Support BBS,
  742.      and telephone support.
  743.  
  744.      Discounts are available if you register Useful Editor along with other
  745.      Useful Software products (see "Bundled" price schedule below).  If you
  746.      are already a registered user of another Useful Software product,
  747.      remit only the difference in price between what you have already paid
  748.      and the "Bundled" price.  (For instance if you own 1 copy of Useful
  749.      Notes at $20, you pay only $10 for the registration of 1 copy of
  750.      Useful Editor).
  751.  
  752.      
  753.      Useful Editor Price Schedule
  754.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  755.      
  756.      1-9   copies  - $20 per copy
  757.      10-49 copies  - $15 per copy
  758.      50-99 copies  - $10 per copy
  759.      100+  copies  - One time fee of $1000
  760.  
  761.  
  762.      Useful Editor/Notes Bundled Price Schedule
  763.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  764.      
  765.      1-9   copies  - $30 per bundle
  766.      10-49 copies  - $25 per bundle
  767.      50-99 copies  - $15 per bundle
  768.      100+  copies  - One time fee of $1500
  769.  
  770.  
  771.      Useful Macros Price Schedule
  772.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  773.  
  774.      1-99  copies  - $10 per copy
  775.      100+  copies  - One time fee of $1000
  776.  
  777.      With each purchased copy of Useful Editor or Useful Notes, the price
  778.      for a copy of Useful Macros is only $5.00.
  779.  
  780.  
  781.      Printed Documentation
  782.      ~~~~~~~~~~~~~~~~~~~~~
  783.  
  784.      Printed copies of the documentation are available for all Useful
  785.      Software products at a cost of $5.00/copy.
  786.  
  787.  
  788.  
  789.      REGISTRATION FORM (English Ued)
  790.      =================
  791.  
  792.  
  793.      TO:                      FROM:
  794.  
  795.      Useful Software             Name: ___________________________________
  796.      340 Dale Crescent
  797.      Waterloo, Ontario      (Company): ___________________________________
  798.      Canada, N2J 3Y3
  799.                               (Title): ___________________________________
  800.  
  801.                               Address: ___________________________________
  802.  
  803.                            City,State: ___________________________________
  804.                                (Prov.)
  805.  
  806.                             Telephone: ___________________________________
  807.  
  808.  
  809.      I AM ALREADY USING:
  810.  
  811.         Useful Editor Version ___.___
  812.  
  813.         Useful Notes  Version ___.___
  814.  
  815.         Useful Macros Version ___.___
  816.  
  817.  
  818.      I WOULD LIKE TO REGISTER:
  819.  
  820.         ____ copies of Useful Editor V1.9c  X  $______ per copy = $________
  821.  
  822.         ____ copies of Useful Notes  V1.3   X  $______ per copy = $________
  823.  
  824.         ____ copies of Useful Macros V1.0   X  $______ per copy = $________
  825.  
  826.  
  827.      I WOULD ALSO LIKE TO RECEIVE:
  828.  
  829.         ____ printed copies of the Editor documentation X $5.00 = $________
  830.  
  831.         ____ printed copies of the Notes  documentation X $5.00 = $________
  832.  
  833.         ____ printed copies of the Macros documentation X $5.00 = $________
  834.  
  835.  
  836.                                                  TOTAL ENCLOSED = $
  837.                                                                    ========
  838.  
  839.  
  840.  
  841.      Signature: ____________________________________
  842.  
  843.  
  844.  
  845.  
  846.      Update Log
  847.      ~~~~~~~~~~
  848.  
  849.      The following changes were made in Version 1.1
  850.  
  851.         - fixed shift left/right display bug
  852.         - altered load routine to convert 0s to spaces on input
  853.         - added 43/50 line support
  854.         - files with no CR/LF on last line now handled properly
  855.         - config will no longer let you pick fore/background colours the
  856.           same
  857.         - you can now use ^ in search strings
  858.  
  859.  
  860.      The following changes were made in Version 1.2
  861.  
  862.         - fixed delete word bug (would not delete if you were on the first
  863.           letter of a word)
  864.         - modified Text Set/Enter Right Margin command to automatically
  865.           turn on word wrap
  866.  
  867.  
  868.      The following change was made in Version 1.3
  869.  
  870.         - added wild card expansion of file names on command line
  871.  
  872.  
  873.      The following changes were made in version 1.4
  874.  
  875.         - a warning is now issued if a file is changed when loaded (Ued
  876.           will substitute a space for any null (0) character found and/or
  877.           split lines that are too long (>999 characters))
  878.         - Ued now uses the DOS interrupt 21 console I/O routine (function
  879.           6) to fetch keystrokes (this should facilitate the use DOS key
  880.           remappers) (removed in version 1.6 - BIOS interrupt 16 used)
  881.         - a bug when word wrapping lines >80 columns was fixed
  882.         - a display error when reading zero length files was fixed
  883.         - editing of filenames and search patterns has been improved and in
  884.           addition the last filename or pattern can be recalled by pressing
  885.           the  key
  886.         - added the option of creating backup files when saving
  887.  
  888.  
  889.      The following changes were made in version 1.5
  890.  
  891.         - added configuration support to allow Ued to start up in word wrap
  892.           mode
  893.         - Ued now allows you to edit while a file is being loaded (removed
  894.           in version 1.6)
  895.         - changed Ued to load "piped" files in BINARY mode (thus ignoring
  896.           EOF characters in the file)
  897.  
  898.  
  899.  
  900.      The following changes were made in version 1.6
  901.  
  902.         - added the Back/Next Workspace commands under the Cursor menu
  903.         - when a new pattern is entered the replacement string is no longer
  904.           automatically cleared
  905.         - the first file name entered on the command line is now copied to
  906.           the "Previous Filename" buffer
  907.         - the field for entering the default word wrap column in uedcfg has
  908.           been increased to 3 characters
  909.         - the performance when loading and saving files has been improved
  910.           considerably
  911.         - a low pitch beep has been added when invalid keys are pressed
  912.           within commands
  913.  
  914.  
  915.      The following changes were made in version 1.7
  916.  
  917.         - support for VGA 28 line mode added
  918.         - the "archive" bit is now being set correctly when saving
  919.         - Ued now recognizes lines beginning with a '.' or a ':' as being
  920.           the equivalent of a blank line when reformatting paragraphs
  921.         - Alt-x can be used as an alternate to F10 (Quit)
  922.         - empty workspaces can now be saved creating a 0 length file
  923.  
  924.      
  925.      The following changes were made in version 1.8
  926.  
  927.         - extended characters (with ASCII values > 127) can now be typed
  928.           into Patterns and Replacements
  929.         - at the Filename? prompt when loading you can get a list of files
  930.           by typing in a file specification with the standard DOS wildcard
  931.           characters (*,?) or by pressing Enter with no file name for all
  932.           files
  933.  
  934.  
  935.      The following changes were made in version 1.9
  936.  
  937.         - a problem with the keyboard on some systems (PS/2 Model 60, old
  938.           XTs and others) misreading the function keys unless NumLock was
  939.           on has been corrected
  940.         - the Text/Set right margin command will now leave a space at the
  941.           end of the longest line of text in all instances
  942.         - you can now have keys "automatically" typed into Ued (say via a
  943.           TSR or the Window's 3.0 clipboard) at a much higher rate
  944.         - Uedcfg will now generate a "ued.cfg" file or can be forced to by
  945.           typing "uedcfg /s" and will restore an older configuration with
  946.           the command "uedcfg /r"
  947.         - you cannot save to a "Read Only" file when automatic backups are
  948.           on any more (Ued used to make the .bak file Read Only then save
  949.           the file)
  950.  
  951.  
  952.      The following changes were made in version 1.9c
  953.  
  954.         - when you reach the left or right edge of the screen, the window
  955.           shifts 20 columns so that you can see more context
  956.         - optimized memory management so that larger files could be loaded
  957.         - also added a /l command line argument so that even larger files
  958.           can be loaded
  959.  
  960.  
  961.  
  962.      Planned Enhancements
  963.      ~~~~~~~~~~~~~~~~~~~~
  964.         - when remembering the previous file, if the filaname had wild card
  965.           characters then remember the pattern
  966.         - remember more patterns and replacements
  967.         - copy patterns to replacement
  968.         - hide main command menu
  969.         - add internal macro support
  970.         - read only should not let user's type or change document
  971.         - support the command line arguments might be
  972.           > /tnn - set tabs
  973.           > /wnn - toggle word wrap set ww column
  974.           > /i   - toggle insert mode
  975.           > /25 /28 /43 /50 - set line mode
  976.           > /l   - large files
  977.           > /r   - read only
  978.           > /pn  - printer port
  979.         - Printer Stuff
  980.           > allow user to configure the printer port
  981.           > option to send a formfeed when done the workspace
  982.         - make clear workspace a configurable option
  983.         - allow #0 and #1 in patterns and replacements to represent 
  984.           the ascii characters 0 and 1
  985.         - add the beginning and end of line character #b #e to patterns
  986.         - let the user define what the space characters are
  987.         - make remove spaces from ends of lines configurable
  988.         - record rows and restore video mode accordingly on exit
  989.         - option to turn off smart indent
  990.         - select colour/attributes of cursor
  991.         - ctrl up/down scroll file while leaving cursor in place
  992.         - ctrl-ins (cut) shift-ins (paste)
  993.         - include trailing blank lines in cut buffer
  994.         - show more context when searching
  995.  
  996.  
  997.